Component Options

This section describes how to configure an individual option for a component that is applicable to the entire project.You can also configure on a per file/folder basis. See qacli project files for more information.

By default, only "basic" component options are shown. If you need to view "advanced" component options, then ensure the ‑‑advanced option is added to the command.

Any command below can operate on a Helix QAC project (i.e. ‑P <directory>) can also operate on different configuration within that project. To use a different configuration, add ‑K <config-name> to the command.

List Component Options

To list the options available for a given component:

qacli pprops -c <component_key> --list-options

Detailed List of a Component Option

To print detailed component option information (name, shortcut, argument, argument syntax, cumulativity, default value, description):

qacli pprops -c <component_key> -o <option> -i

The name of the option does not have to be prefixed with a dash. For example, “‑o enabledataflow” and “‑o ‑enabledataflow” are equivalent.

Set a Single Component Option

To set a component option for a project, or to add to the options if cumulative:

qacli pprops -c <component_key> -o <option> --set <value> -P <directory>

If the component is present in more than one toolchain in the particular project, disambiguation is required using the ‑‑toolchain (‑T) switch.

The name of the option does not have to be prefixed with a dash. For example, “‑o enabledataflow” and “‑o ‑enabledataflow” are equivalent.

Set Multiple Component Options

To set several component options from a file for a project—or to add to the options if cumulative—use the following:

qacli pprops -c <component_key> -P <directory> --options-file <opt-file> --set-options

The opt-file lists pairs of values, in the format “‑<option> value”, in a similar format to a .via file.

Using an option file is significantly quicker than setting options individually using the ‑set option.

Set a Component Option Once

To set a component option only once for a project:

qacli pprops -c <component_key> -o <option> --set-once <value> -P <directory>
If the component option is already set multiple times, then this option will not add it again.

Reset a Component Option

To reset a component option to its default value for a project:

qacli pprops -c <component_key> -o <option> --reset -P <directory>

View all Options in a Project

To view the values of all the options of a component in a project:

qacli pprops -c <component_key> --view-values -P <directory>

This does not list default values, as these are not stored in the project. They can instead be viewed in the option information.

Reset All Component Options

To reset the values of all the options of a component in a project:

qacli pprops -c <component_key> --reset-component -P <directory>

This will output the options that are reset.